home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / aprs503a.zip / README.HLP < prev    next >
Text File  |  1994-05-21  |  26KB  |  462 lines

  1. README.HLP                   APRS HELP DOCUMENT
  2.  
  3.      In version 5.00 the more than 60 APRS commands have been simplified
  4. by eliminating most Ctrl and ALT keys and by placing these functions in
  5. a few sub-menus.  This is a major functional change.  Old users BEWARE!
  6.  
  7.      In most cases, all APRS commands are active from all pages and APRS
  8. processing of packets continues in the background.  (An exception is while a
  9. BLUE-BOXED prompt is on the screen).  The first Help page defines all command
  10. characters.  To begin with, APRS has eight major display screens:
  11.  
  12.   MAP       - For showing the positions of all stations and objects
  13.   LATEST    - Shows the latest Beacon or broadcast message for all stations
  14.   POSITIONS - Shows position packets and comments from all stations and Objs
  15.   HEARD LOG - Shows station activity in number of packets per hour per station
  16.   READ MAIL - Shows the last 23 message lines heard between any stations
  17.   DIGIs USED- Shows digipeater paths used by all stations
  18.   ALL BCNS  - Chronological log of all beacons and messages
  19.   VIEW      - Scrolling screen of all packets on frequency
  20.  
  21.  
  22. DISPLAY SCREENS:  Each display page is called up with a single key command as
  23. shown below.  If there are more than one page of packet stations in the net,
  24. then use the PgUp and PgDn keys to cycle through multiple pages.  On both the
  25. P and L lists, you can move the cursor to select a single station.  A prompt
  26. then allows you to (1) display the object on the screen, (2) see a chronologi-
  27. cal list of all previous beacons from that station, (3) delete the entry,
  28. (4) insert a position for a BEACON only station, etc.
  29.  
  30.   L - LATEST DISPLAY - Lists the latest BEACON packet from all stations.  This
  31.       screen is like a braodcast message display showing the latest bulletin
  32.       from each station. This screen is updated in realtime as packets come in.
  33.  
  34.   P - POSITIONS DISPLAY - Lists the latest POSITION packet received from each
  35.       station.  Since each position report can contain comments, this display
  36.       is useful for seeing comments and resolving position data.  You may
  37.       select (HOOK) any station or object in this list for manipulation.  See
  38.       the section on OBJects.  Also the JUST ONE command works on this display
  39.       to show JUST one type of stations at a time.  On the PList, you can HOOK
  40.       any object or station with the cursor and then you may execute a number
  41.       of different commands on that object:
  42.  
  43.           U or Q - Uplink or Quit uplinking that object
  44.           Move   - Move it anywhere else on the map
  45.           Show   - Center the map on the object
  46.           Delete - Deletes the object from your list
  47.           Just   - Lists only stations or objects of JUST one type
  48.           Kill   - Stops display of your object on EVERYONE's screens!  It
  49.                    remains in their list but just does not clutter the map.
  50.  
  51.   H - HEARD - This display shows statistics of the number of packets heard
  52.       from each station for the last 24 hours.  It is useful for observing
  53.       station activity and on HF for observing propagation changes.
  54.  
  55.   R - READ MAIL - This screen monitors all messages on the frequency and keeps
  56.       the last 23 lines heard.  This screen is useful for "READING the MAIL"
  57.  
  58.   D - DIGIPEATER PATH - This display shows the raw packet header including
  59.       the digipeater paths used by all stations in your LATEST list.  Proper
  60.       use of digipeaters is very important for minimizing QRM on APRS nets.
  61.  
  62.   A - ALL PACKETS - This display shows a chronological history of all packets
  63.       received.  It also includes your incoming and outgoing message lines.
  64.       Since messages do not have a time of receipt appended to them, this
  65.       display is useful for seeing approximately when a message line was
  66.       received.
  67.  
  68.   F1 - HELP - Gives a menu of several different pages of HELP
  69.  
  70.  
  71.  
  72. MAP DISPLAY:  The map display is the most important display in APRS.  It shows
  73. a map of the packet network area and the positions of all reporting stations.
  74. Stations reporting packet positions over the air are shown in white, objects
  75. that you are reporting to the network (uplinking) are shown in yellow, objects
  76. reported by other stations are shown in purple, positions that have not been
  77. updated in 2 hours are shown in gray.  To help highlight the WIDE area
  78. digipeaters in an APRS net, the WIDE digipeaters are shown in green.  All
  79. weather stations are shown in blue.
  80.  
  81.   SPACE   - Displays the current map.  By marking important or special objects
  82.             with a # on the P-list, you can display the map with all other
  83.             stations or objects suppressed by simply hitting the # key.  If
  84.             you press *, all symbols will be displayed, but only the calls
  85.             of the marked stations will be shown (useful for tracking a mobile
  86.             through a maze of fixed stations..)
  87.      
  88.   ARROWS  - Move the map cursor on the screen.  If you turn NumLok off then
  89.             hold the shift key with the white arrow keys, then cursor will
  90.             move 5 times faster.
  91.  
  92.   PgUp/Dn - Zooms the display in and out by a factor of 2.  Ctrl-PgUp/Dn
  93.             zooms by a factor of 8.
  94.  
  95.   Home    - Will home the center of the screen to the current cursor location
  96.  
  97.   End     - Will return the map to your default position stored in CONFIG file
  98.  
  99.   1,3,5,9 - These are map memories that you can use to save particular maps
  100.             of interest to you.  Save a map using the MAP-SAVE command and
  101.             recall any of these using the indicated number key.  The 1 key
  102.             always has the whole USA in it.
  103.  
  104.   F9      - CNETER ALL CONTACTS.  This special function will calculate the
  105.             best map range and center ALL stations heard by you on one map.
  106.  
  107.   J       - JUST ONE - Used to display just one symbol type at a time.
  108.             to selectively display stations like all WX stations.
  109.  
  110.   HOOK    - Hook is a Navy term for selecting an object on a radar screen. Use
  111.             the RETURN/ENTER key to hook an object at the cursor location.  To
  112.             progressively hook one object after another, use the  +/- keys.
  113.             The POSITION and BEACON packets from a hooked station are displayed
  114.             on the bottom of the screen.  While a station is hooked, it can be
  115.             moved by moving the cursor to the new location and hitting the
  116.             INSert key or it can be removed using the DELETE key.  To prevent
  117.             inadvertent movement of objects, a second RETURN key UNHOOKS.
  118.  
  119.   INSERT  - Relocates a HOOKED object on the screen.
  120.  
  121.   DEAD RECKONING:  Since APRS dead-reckons the position of moving objects as
  122.             time progresses, the symbol on the map is presented where it
  123.             SHOULD be, but NOT where it was when first reported.  If you use
  124.             the cursor to try to hook one of these objects on the map, you
  125.             must hook the little gray circle which marks the position of the
  126.             actual report, and not the symbol itself.
  127.  
  128.  
  129. MAP MENU:  Many of the MAP features and other commands affecting maps have
  130. been moved to the MAP MENU.  The following commands apply:
  131.  
  132.   A - ALTmap   Displays the map UNDER the current map.  Since APRS always uses
  133.       the latest map in the MAPLIST.APR file that meets the current
  134.       screen conditions, areas where maps overlap may sometime be
  135.       obscured.  This command displays the next higher map in the list.
  136.  
  137.   B - Borders  Shows borders of all MAPS in the MAPLIST.apr file.  If A map
  138.       border appears, but does not come up, then the MAP file is
  139.       missing.  If the Map file exists but the borders do not show
  140.       up, then the file is not listed in the MAPLIST.apr file.
  141.  
  142.   F - Features Toggles a number of map features on/off.  Features are Boundaries,
  143.       Headings, Roads, Calls, Waterways, etc.  ALL features can also be
  144.       turned on/off at once.  This is useful for slow 8088 PCs where
  145.       turning off the map still shows the relative positions of stations
  146.       but without taking the 10 seconds required to draw the maps.
  147.  
  148.   R - RANGE RINGS - Displays one ring at the current range scale and another
  149.       at half the range.
  150.  
  151.  
  152.  
  153. MESSAGE TRAFFIC:  There are two types of messages in APRS.  First are broadcast
  154. messages (beacons) to all stations.   New BEACONS are shown at the bottom of
  155. all APRS screens on frequency and highlighted in green so that all stations see
  156. the new message or change in status.  They are also added to the ALL and LATEST
  157. pages of all stations on frequency.  These beacons are perfect for alerting the
  158. net to your current status.  Secondly, APRS implements a one line message
  159. traffic capability between operators.  Each line is ACKed when received by the
  160. other station.  Multiple lines can be buffered up for eventual delivery.
  161.  
  162. TRAFFIC COMMANDS:
  163.  
  164.   B - Displays your latest Beacon message.
  165.  
  166.   T - Displays traffic on the current screen.  If messages are already on the
  167.       current screen, then T forces a one-time transmission of all messages,
  168.       without changing the current timing.   Whenever you call up a new
  169.       APRS screen, the messages are overwritten.  They will reappear if there
  170.       is any change, such as an incoming message line or an ACK to one of
  171.       your outgoing lines.
  172.  
  173.   S - SEND MESSAGE - You are then prompted for the callsign of the station
  174.       that you want the message to go to.  If you already have outgoing
  175.       message lines pending, then the previous station callsign is pre-loaded.
  176.       If you don't want to send the message, just enter a blank line.
  177.  
  178.       NOTE: APRS messages are the least efficient APRS mechanisim.  Intense
  179.       real-time rag-chews on a busy APRS frequency should be done without
  180.       digipeaters or with only the exact path specified, or should be done
  181.       more efficiently using the TNC in a normal AX.25 connection.
  182.  
  183.       ACKS:  When your MSG is acknowledged, the word *ACK* (or *REJ* if his
  184.       screen is full) will be over printed on the outgoing MSG line.  Note that
  185.       unlike normal packet, APRS does not compute the return path for an ACK.
  186.       Each station must set his outgoing VIA path so that his packets
  187.       (including ACKs) get back to all stations in the net.  On the 5th DUPE
  188.       of an incoming message, APRS will warn you that the other station is
  189.       probably not getting your ACKS!
  190.  
  191.   K - KILL incoming message lines.  K key kills one line at a time.
  192.  
  193.   E - ERASE outgoing lines.  E key erases one outgoing line at a time.  First
  194.       it erases *ACKed* messages, and then erases other lines.
  195.  
  196.  
  197. FILES MENU:  All commands dealing with files have been placed in the FILES
  198. Menu.  These commands are as follows:
  199.  
  200.   D - DOS Shell - allows you to shell to DOS for whatever purpose...
  201.  
  202.   L - LOAD - This key allows you to load a backup file.  The file named BACKUP
  203.       is saved every time you quit APRS so that you can restart the program
  204.       to the last on air situation.  I save a different file for each packet
  205.       frequency so that my map only shows stations on the current frequency.
  206.       To facilitate this process, you only need to enter the numeric digits
  207.       to LOAD a backup FREQxxxx or HFxxxx file.  To load the BACKUP file, just
  208.       enter the letter B for the filename.
  209.  
  210.   A - APPEND - This will permit you to load in a BACKUP file without losing
  211.       all the stations that are already in your P and L lists.  If the same
  212.       calls are in the appended file as are already in memory, there will
  213.       be numerous dupes that should be manually deleted.  Also, APPEND does
  214.       not append any LOG or WHEN-HEARD data. 
  215.  
  216.   O - ORDER THE LATEST LIST - Moves older beacons to the start of the list,
  217.       and the most recent beacons to the end. 
  218.  
  219.   S - SAVE - Used to save the current situation in a file.  The file name
  220.       defaults to the name of the last file loaded.  It is a good idea to
  221.       save a separate file for each packet frequency on which you operate.
  222.  
  223.  
  224. OPERATIONS MENU:
  225.  
  226.   C - COMMS - This commmand allows you to disable APRS and talk straight
  227.       through to your TNC or GPS/WX/DF COMM port.  Use it to establish a
  228.       direct CONNECTION.  This is useful for connecting to another APRS
  229.       station's internal TNC mailbox to leave a message if he is not on line
  230.       with APRS or for a quick keyboard to keyboard QSO with another APRS
  231.       operator, known to be at his keyboard.  These brief keyboard connections
  232.       are not too disruptive to other APRS operations on frequency as long as
  233.       no computer data is transferred.  Also permits you to monitor your other
  234.       COM port hooked up to GPS or WX.
  235.  
  236.   Q - QUERY This command sends an immediate APRS query packet to all
  237.       stations on frequency.  All APRS stations will respond with all of
  238.       their BEACONS, POSITS, OBJECTS, and MESSAGES sometime in the next 2
  239.       minutes.  This command is AUTOMATICALLY sent when a station starts
  240.       up the  APRS program.  This is why you hear a lot of packet
  241.       activity each time a new APRS station fires up on frequency.  You
  242.       can selectively Query any single APRS station by sending him a one-
  243.       line message with the characters ?APRS in it.
  244.  
  245.   P - PING -  Sends out a ping packet.  If the packet is digipeated by your
  246.       selected VIA path, you will see it monitored on the bottom line of
  247.       your display.  This lets you know that your station is transmitting
  248.       and that the digipeater in your selected VIA path responded.
  249.  
  250.   U - UNPROTO  Used to set up your outgoing digipeater path. (IMPORTANT!)
  251.       If you have not selected a digipeater that covers your APRS net, then
  252.       your packets and acks will never get to the other stations on freq
  253.       even though you see them fine.  YOU MUST SET YOUR VIA PATH TO COVER
  254.       your intended APRS AREA by selecting an appropriate digipeater path!
  255.       APRS will warn you if another station does not appear to be getting
  256.       your message ACKs.
  257.  
  258.  
  259. INPUT POSITIONS MENU:  Any station may place an object on the map for display
  260. at all stations.  Once on the screen, the object is listed in the P-list with
  261. a (+) symbol.  This means it will be transmitted by your station.  You can QUIT
  262. transmitting each object by hooking it on the P-list and hitting Q.  Users with
  263. an un-validated copy of APRS are limited to uplinking only one object.  Even
  264. if you delete the object from your screen, or have quit sending it, it still
  265. remains on all screens in the network until each individual operator
  266. deletes it.  In version 4.06, you can now kill an OBJECT which will
  267. remove it from all screens (though still keep it on everyone's PList).  If an
  268. object has not been updated in over two hours, it fades to a gray color.
  269.   
  270.   A - ADD a new object to the screen at the current cursor location.  You
  271.       are prompted for all pertinent information.  There are over 50 symbols
  272.       that can be used to display the object.  Some are specific and some
  273.       are generic so that they can be defined for each special APRS net.
  274.  
  275.   F - FIX your own POSIT.  Allows you to enter your LAT/LONG directly
  276.  
  277.   E - ENTER L/L   This command allows you to add an object without having to
  278.       slew the cursor to the desired location first.  It is useful when
  279.       you are given the L/L of the object, such as for entering the
  280.       position of reported hurricanes.
  281.   
  282.  
  283. CONTROLS:  There is a status display called the control panel which can be
  284. displayed at the bottom of the screen.  It shows the status of all toggle
  285. on/off functions, your validation status and your VIA path.  Items in lower
  286. case are OFF and upper case are ON.  Example:
  287.  
  288. ------------------------------------------------------------------------------
  289. | NEW | GPS | XMT | UP | DR | LOG | FLTR | BCNS | cw | VHF | DIGI-1,DIGI-2     |
  290. ------------------------------------------------------------------------------
  291.  
  292.   W - CW - Toggles CW mode on and off for new incoming messages
  293.       lines to you are sounded out in CW if you are not near your CRT.
  294.  
  295.   D - DEAD RECKONING ON/off
  296.  
  297.   F - FILTER ON/OFF -   If a position is the same (within 20 yards or
  298.       .01 minute of LAT/LON), then the report is not saved in memory or to a
  299.       track history file.  If this POSITION filter is on, then the comparison
  300.       is made out to 80 yards to include most of the randomness added to the
  301.       GPS system by the Deaprtment of Defense.  This prevents non-moving GPS
  302.       packet stations from filling up track history files with redundant
  303.       positions.  In version 3.08, when the 80 yard filter is disabled, this
  304.       also turns on a WX saver routine which will save all Weather reports in
  305.       the Track History file for later trend analysis.
  306.  
  307.   G - LOG - Toggles on and off the automatic logging of track histories to
  308.       file.  Default is ON so that after 150 position reports, a file is
  309.       automatically saved and memory is cleard for further accumulation.  If
  310.       off, the 150 reports are retained in memory until you QUIT.
  311.  
  312.  
  313.   O - OTHER Use this command to toggle the APRS beacon processing
  314.       filter between APRS Only packets or ALL OTHER packets.  The state
  315.       of this switch in shown on the control line.  Use OTHER to monitor
  316.       non APRS frequencies to collect BEACONS and see who is on the air.
  317.  
  318.   U - UPLINK ENABLE - Toggles on/off.  If on, then your objects marked
  319.       for uplinking, will be uplinked to all stations in the net.
  320.  
  321.   X - XMT ON/OFF - disables routine transmitting from your station.  This is
  322.       good for stations monitoring an event, but not actively participating.
  323.       It keeps their routine beacons off the frequency.  The X key will force
  324.       a one time transmission of your BCN, POS, OBJ, and MSG packets and your
  325.       station will still ACK incoming messages.
  326.  
  327.  
  328. SETUP MENU:  This command allows the selection of all SETUP functions.  These
  329. functions can be saved in a configuration file by registered users
  330.  
  331.  
  332.   B - BEEPS Toggles nuisance BEEPS on and off.
  333.  
  334.   G - GPS FUNCTIONS:  Used to set up SPM - Single Port Mode, HSP - Hardware
  335.       Single Port mode, TIME-SYNC (sync's PC clock to the next GPS report
  336.       received).  Be cautions, since stand-alone PACCOMM TNC trackers first
  337.       store the GPS data and then transmit it based on an internal timer, the
  338.       actual GPS data transmitted may not be real-time.  This is true if the
  339.       GPS loses lock or becomes inoperateive, then the TNC continues to send
  340.       the same "old" fix.  If you sync to one of these, you are syncing to
  341.       "old" time!
  342.  
  343.   I - INITIALIZE TNC - sends out TNC commands to setup the TNC for APRS.
  344.       Your TNC is automatically initialized when you start, but can be done
  345.       at any time, if your TNC loses power, or needs to be reset to APRS
  346.       defaults.  When you QUIT APRS, it gives a list of TNC parameters that
  347.       were changed by APRS.
  348.  
  349.   S - SAVE CONFIG FILE - Used to save your current configuration.  Saves
  350.       the current map size and location as well as the state of HF/VHF, and
  351.       your digipeater path.  You will be prompted for your Validation number
  352.       the first time you do a CONFIG file save.  If you have chosen any of
  353.       the GPS, DF or WX options, you will also be prompted for your auxilliary
  354.       registration number as well.  You can save each CFIG file with an
  355.       optional 3 character file extension so that you can call them up quickly
  356.       for different applications.  You invoke the optional files with a /EXT
  357.       switch when you give DOS the APRSxxx command.  IE:  C:> APRS406/MOB would
  358.       load the CFIG406.MOB file which you saved when you operated MOBile.  etc
  359.      
  360.   W - WIDE  Permits an APRS station to override the normal APRS default ALIAS of
  361.       RELAY and set it to the generic WIDE area address so he can serve as
  362.       a temporary WIDE digi.  Do this only with the concurrence of others
  363.       on Frequency.
  364.  
  365.  
  366.  
  367. WEATHER COMMANDS:  APRS displays weather stations as large blue circles with
  368. a white line showing the wind speed and direction.  Remember that APRS uses
  369. 360 degrees for North and assumes that 000 means no direction information is
  370. available.  Under the CONTROLs menu, the FILTER command allows you to disable
  371. the POSITION FILTER so that WX reports will be saved to track history files
  372. for trend analysis.  Other WX commands under the WEATHER MENU:
  373.  
  374.   E - Enter a weather report.  Used to enter a manual WX report.  The word
  375.       (manual) will be added at the end of the report to indicate that it
  376.       was a one time synopsis and that APRS should not update the Date-Time
  377.       each time it is transmitted.
  378.  
  379.   G - GET NWS SITES - Loads all National Weather Service sites on the present
  380.       map display into the P-list.  This is so that an hourly WX data file
  381.       can be loaded for all all NWS sites listed.
  382.  
  383.   J - Use the J command to select Just Weather stations for display.
  384.  
  385.   L - LOAD WX DATA - This key will search a designated file for NWS hourly
  386.       weather advisories.   For each NWS station listed in both the data file
  387.       and already in your P-list, the current conditions will be loaded.  Use
  388.       the G command to pre-load your P-list with the NWS stations near you.
  389.  
  390.   N - NEXT WX STATION - Highlights the next weather station in turn and
  391.       displays the WX conditions in the weather box at the top of the screen,
  392.       and circles the station on the map for identification.  The Weather box
  393.       at the top of the screen will automatically be updated everytime the
  394.       selected WX station sends out a WX report.
  395.  
  396.   Q - WEATHER QUERY - Same as QUERY, but only weather stations respond.
  397.  
  398. TRACKING and TRACK HISTORIES - All position reports are saved to memory and
  399. eventually to file for subsequent replay.  Each new position report is checked
  400. against the last position from that unit and the current values.  If the
  401. POSITION filter is ON (default) then a new position will not be saved to
  402. track history unless movement is more than about 80 yards.  This is to reduce
  403. the number of track points for non-moving stations saved in the file.  There
  404. are several commands related to station tracking:
  405.  
  406.    T - TRACK - This is a subcommand on the P-list display which allows you to
  407.        designate a station for tracking.  If TRACK is on, then the map will
  408.        always re-center on the selected station whenever it approaches a map
  409.        edge.  This re-centering anticipates the station's movements and
  410.        recenter's the map to give the best next view.
  411.  
  412.    A - ALARM - This is also a subcommand on the P-list which allows you to set
  413.        an alarm on a given station.  If that station moves, APRS will beep and
  414.        will re-center the map to track that station.  The same filter as used
  415.        on the P-list is also used here so that the randomness of Selective
  416.        Availability does not unnecessarily trigger this alarm.  You can silence
  417.        the beeping by UNHOOKING the station, or by deselecting the ALARM
  418.        function.  Only one ALARM can be set at a time.
  419.       
  420.  
  421.    M - MOVE - A subcommand on the P list for moving a station.  Similar to
  422.        just hooking it with the RETURN key, but is the only way to move an
  423.        object or station with 00000/00000  for LAT/LONG.
  424.  
  425.    S - SAVE FILES - On the FILES MENU, this command forces a save of a BACKUP
  426.        a BLxxxxxx,LOG and a TKxxxxxx.HST file.  If you are in the field, and
  427.        may possibly lose power, do a SAVE now and then, to be sure you save
  428.        all track histories.  After the event, you can use a DOS text editor
  429.        to append all the track history files together for the one event.
  430.        When you Quit APRS, ONLY a Backup file is saved, the LOG and TRACK
  431.        data are LOST!  If, however, you give the BACKUP file any OTHER name,
  432.        then a LOG and TK.HST file ARE saved when you quit.
  433.  
  434.    REPLAY - Found in both the FILES and OPERATIONS MENUS.  One REPLAYS from
  435.        on-line memory, and the other from a previously saved TRACK file.
  436.        Track histories are retained in memory for instant replay up to 150
  437.        points.  When memory is full, a file is automatically saved and memory
  438.        cleared for more points.  If less than 150 points are in memory, you
  439.        MUST MANUALLY force a save BEFORE exiting the program or the
  440.        track history points in memory will be lost!  During Replay several
  441.        commands are useful to center the screen on the moving object, change
  442.        the speed of replay and zoom in or out, etc.
  443.  
  444. DIRECTION FINDING:  APRS can instantly traingulate fixes from multiple reporting
  445. packet stations.  Even stations reporting a beam haeding that are not APRS
  446. equipped, can be placed on the map by any APRS station using the ADD command
  447. and be given a beam heading.  APRS assumes that any station or object using
  448. the TRIANGLE symbol is a DF station and will plot a line of bearing if given.
  449. Note that APRS uses 360 degrees as North and assumes 000 means no direction
  450. information available.  A quality of 8 indicates an excellent fix.
  451.  
  452.    B - BEAM HEADING - In the OPERATIONS MENU is used for entering a beam
  453.        heading for your station.  If you are running the WX station option,
  454.        it will be dissabled while the DF report is operative.  You may also
  455.        specify a Quality factor 1-8.  The more dotted the line is, the less
  456.        its quality.
  457.  
  458.    ON/OFF - The HEADING function on the MAP FEATURES MENU can be used to
  459.        turn beam headings and DF bearings on and off.
  460.      
  461.  
  462.